errorDialog

Type

message

Summary

Sent to an object when one of its handlers cannot be run due to an execution error.

Syntax

errorDialog <pExecutionError>, <pParseError>

Description

Handle the errorDialog message to prevent the standard error window from appearing, when you want to handle the error in a custom handler.

Standard error descriptions are stored in the cErrorsList of the first card of stack "revErrorDisplay". The error-code refers to the line number in this custom property which contains the error description.

You can look up the description of an error using this line of code:

    answer line (item 1 of line 1 of pExecutionError) of the scriptExecutionErrors

note

The exact format of the executionError may change from release to release.

If the lockErrorDialogs property is true, the errorDialog message is sent to the object that set the lockErrorDialogs, rather than to the object whose script contained the error. The lockErrorDialogs can be set to true either by setting the property directly, or with the lock error dialogs command.

note

The errorDialog message is only sent while Script Debug mode is turned off. To toggle Script Debug mode, click on the Development menu of LiveCode's menubar.

Parameters

Name	Type	Description
pExecutionError		Describes the error that occurred in the form of a standard LiveCode error backtrace: error-code,line-number,column-number[, hint]
pParseError		Deprecated

Examples

on errorDialog pExecutionError, pParseError
    answer "An error occurred on line: " & item 2 \
          of line 1 of pExecutionError
end errorDialog

Related

glossary: object, property, handle, handler, error, message, execution error, command

message: scriptParsingError

property: executionContexts, lockErrorDialogs, script

command: lock error dialogs, unlock error dialogs

function: interrupt, format, errorObject

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

Platforms

desktop

server